home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / macros / mathematica / tex-mma.tar_z / tex-mma / README < prev    next >
Text File  |  1991-04-25  |  8KB  |  223 lines
  1. TeX/Mathematica is a set of tools that provide facilities of
  2. Mathematica Notebooks in a UNIX environment, under GNU Emacs.  They
  3. permit interaction between a text and a Mathematica buffer and, if
  4. desired, the use of TeX/LaTeX to annotate Mathematica-based
  5. explorations and programs.  Inclusion of Mathematica-generated
  6. graphics in TeX/LaTeX documents printed using PostScript is
  7. supported.  The tools also support the automatic generation of
  8. Mathematica packages from Mathematica documents.
  9.  
  10. With these tools one can interactively develop and refine teaching and
  11. research documents. The interactive nature of the tools encourages
  12. Mathematica-based exploration as a natural part of the writing
  13. process.
  14.  
  15.  
  16. Getting TeX/Mathematica
  17. ***********************
  18.  
  19. The TeX/Mathematica tools are available from Internet host
  20. `chem.bu.edu' [128.197.30.18] by anonymous `ftp' in directory
  21. `/pub/tex-mathematica'.  The author can be reached at Internet address
  22. `dan@chem.bu.edu'.
  23.  
  24. The `ftp' directory contains four files
  25.  
  26.    * `README', which duplicates the information
  27.      in this node.
  28.  
  29.    * `CHANGES', which describes changes that have been made.
  30.  
  31.    * `tex-mma-j.ps.Z', the compressed PostScript documentation/example.
  32.  
  33.    * `tex-mma.tar.Z', the TeX/Mathematica distribution kit (includes the
  34.      first three files).
  35.                 
  36.  
  37. LaTeX description of TeX/Mathematica
  38. ====================================
  39.  
  40. The PostScript document `tex-mma-j.ps.Z' is derived from the LaTeX
  41. description of TeX/Mathematica.  Transfer the document from the
  42. `ftp' directory in binary (image) mode and then print it with
  43.  
  44.      zcat tex-mma-j.ps.Z | lpr
  45.  
  46. The source for this document is the LaTeX file `tex-mma-j.tex' and
  47. the BibTeX file `tex-mma-j.bib'.  You can use `tex-mma-j.tex'
  48. as a LaTeX example of a TeX/Mathematica document.
  49.  
  50.  
  51. Files in the distribution kit
  52. =============================
  53.  
  54. The file `tex-mma.tar.Z' contains the TeX/Mathematica
  55. tools.  These consist of the following:
  56.  
  57. Documentation things:
  58.  
  59.  
  60.    * `tex-mma.texinfo', Texinfo documentation of TeX/Mathematica
  61.  
  62.    * `tex-mma.ps.Z', compressed Texinfo document
  63.      formatted with TeX into PostScript
  64.  
  65.    * `tex-mma.info', Info file
  66.      (this file)
  67.      for on-line Emacs documentation
  68.  
  69.    * `tex-mma-j.tex', LaTeX description/example of TeX/Mathematica
  70.  
  71.    * `tex-mma-j.bib', BibTeX file for `tex-mma-j.tex'
  72.  
  73.    * `tex-mma-j.ps.Z', compressed LaTeX documentation formatted in
  74.      PostScript
  75.  
  76.    * `sin3x.ps', Mathematica-generated figure included in
  77.      `tex-mma-j.tex'
  78.  
  79.    * `tex-mma-tex.tex', TeX example of TeX/Mathematica
  80.  
  81.    * `texinfo.tex', TeX macros used to format `tex-mma.texinfo'
  82.  
  83.  
  84. GNU Emacs things:
  85.  
  86.    * `tex-mma.el', the `tex-mathematica' package
  87.  
  88.    * `math.el', David Jacobson's Mathematica mode package (*Note math::)
  89.  
  90.    * `unix-tex-mma.el', example implementation of cell-type `unix'
  91.  
  92.  
  93. TeX/LaTeX things:
  94.  
  95.    * `mathematica10pt.tex', TeX 10 point TeX/Mathematica interface
  96.  
  97.    * `mathematica12pt.tex', TeX 12 point TeX/Mathematica interface
  98.  
  99.    * `mathematica.sty', LaTeX generic TeX/Mathematica interface
  100.  
  101.    * `mathematica.tex', macros for formatting TeX/Mathematica
  102.      documents, used by the preceding files
  103.  
  104.  
  105. Shell scripts and Mathematica commands for processing graphics, and
  106. shell script and template file for Mathematica package assembly:
  107.  
  108.    * `PSTeX.m', generates `psfig'-adapted graphics to a file, without
  109.      PostScript prolog
  110.  
  111.    * `addBBox', shell script called by `PSTeX'
  112.  
  113.    * `PSTeXpro.m', generates `psfig'-adapted graphics to a file, with
  114.      PostScript prolog
  115.  
  116.    * `addBBoxpro', shell script called by `PSTeXpro'
  117.  
  118.    * `addBBoxpro.awk', `awk' script called by `addBBoxpro'
  119.  
  120.    * `PSFile.m', generates full-page graphics to a file, with PostScript
  121.      prolog
  122.  
  123.    * `tex-mma-assemble-package', shell script for Mathematica package
  124.       assembly
  125.  
  126.    * `tex-mma-assemble-package.tmplt', Emacs Lisp template used by
  127.      `tex-mma-assemble-package'
  128.  
  129.  
  130. This is from Cameron Smith (*Note addBBox::):
  131.  
  132.    * `mma.pro.1.2', Mathematica Version 1.2 PostScript prolog.  Note
  133.      that a different prolog will be needed for Mathematica Version 2.0.
  134.      This will be available from the author (*Note Getting tex-math::).
  135.  
  136. These are from Trevor Darrell's `psfig/tex' distribution (*Note psfig::):
  137.  
  138.    * `psfig.pro', `psfig' PostScript prolog.
  139.  
  140.    * `psfig.sty', `psfig' for LaTeX.
  141.  
  142.    * `psfig.tex', `psfig' for TeX.
  143.  
  144.  
  145. Installation procedure
  146. ======================
  147.  
  148.   1. Transfer `tex-mma.tar.Z' in binary (image) mode into an empty
  149.      directory, and extract its contents, with (for example)
  150.  
  151.           zcat tex-mma.tar.Z | tar xvf -
  152.  
  153.   2. Install the Info on-line documentation file `tex-mma.info' where
  154.      your Emacs looks for Info file.  If desired, add a pointer to it to your
  155.      Info directory file so that it will appear in the Info top-level menu.
  156.      The source for `tex-mma.info' is `tex-mma.texinfo'.  The file
  157.      `tex-mma.ps.Z' is the compressed TeX formatted version, made
  158.      using the `texinfo.tex' included in the distribution (see the
  159.      beginning of `tex-mma.texinfo' for directions).  The formatted
  160.      version can be printed with
  161.  
  162.           zcat tex-mma.ps.Z | lpr
  163.  
  164.      It contains complete details of the TeX/Mathematica tools.
  165.  
  166.   3. Edit `tex-mma.el' to
  167.  
  168.         * set `tex-mma-process-string' to the command
  169.           you use to start Mathematica (default is `math');
  170.  
  171.         * set `tex-mma-info-file' to point to where you put the file
  172.           `tex-mma.info'
  173.  
  174.   4. Run `M-x byte-compile' on `tex-mma.el' and store the resulting
  175.      `tex-mma.elc' wherever your GNU Emacs looks for files.
  176.  
  177.   5. Add the following to the GNU Emacs initialization file
  178.  
  179.           (autoload 'tex-mathematica "tex-mma"
  180.                     "Major-mode for interaction with Mathematica from TeX." t)
  181.           (autoload 'plain-tex-mathematica "tex-mma"
  182.                     "Major-mode for interaction with Mathematica from TeX." t)
  183.           (autoload 'latex-mathematica "tex-mma"
  184.                     "Major-mode for interaction with Mathematica from TeX." t)
  185.  
  186.   6. If you do not have David Jacobson's Mathematica mode package
  187.      `math.el', install it following the instructions in `math.el'.
  188.      If you do have `math.el', make sure your version is at least as
  189.      current as the one here, which contains changes necessary for use with
  190.      `tex-mma.el'.  Make sure you place the file `math.el' (or,
  191.      better, the byte-compiled file `math.elc') where your Emacs looks
  192.      for libraries, so that `tex-mma.elc' will be able to load it if it
  193.      is not already loaded.
  194.  
  195.   7. Edit `mathematica.tex' (at the end) to specify where the PostScript
  196.      prolog files `psfig.pro' and `mma.pro.1.2' will be, and put the
  197.      prolog files there.
  198.  
  199.   8. If you are using a LaTeX *earlier* than 2 May 90, edit
  200.      `mathematica.sty' according to the comments there.
  201.  
  202.   9. Put `mathematica.tex', `mathematica.sty', `mathematica12pt.tex',
  203.      `mathematica10pt.tex', `psfig.sty', and `psfig.tex' where your
  204.      TeX looks for macro files.
  205.  
  206.  10. Put `PSTeX.m', `PSTeXpro.m' and `PSFile.m' where your
  207.      Mathematica looks for packages.
  208.    
  209.  11. Edit `addBBoxpro' to specify which `awk' you use (default is GNU
  210.      awk, `gawk').
  211.  
  212.  12. Edit `tex-mma-assemble-package' to set the variables `bindir', `tmpdir'
  213.      and `tmpdirsed' for your system, as described in the comments there
  214.      and then place `tex-mma-assemble-package.tmplt' in `bindir'.
  215.  
  216.  13. Put `addBBox', `addBBoxpro', `addBBoxpro.awk' and
  217.      `tex-mma-assemble-package' on your system's binary search path, make sure
  218.      they have execute status, and then execute `rehash'.
  219.  
  220.  
  221. You should be ready to go: Startup emacs, run `M-x tex-mathematica'
  222. and have fun.
  223.